home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / biz / swood / Fontaloger.lha / Fontaloger.doc < prev   
Text File  |  1998-02-20  |  14KB  |  328 lines
  1.  
  2.  *#######################################################################*
  3.  *                                                                       *
  4.  *       Fontaloger V1.1 - Final Writer Arexx Script                     *
  5.  *       Andrew M. Haas (20-Feb-98)                                      *
  6.  *                                                                       *
  7.  *       EMail: AndyHaas@wcnet.org                                       *
  8.  *                                                                       *
  9.  *#######################################################################*
  10.  
  11.  
  12. Introduction:
  13.  
  14.     Fontaloger is a Final Writer ARexx macro which will print all fonts 
  15.     in a specified path. The font name will be printed using a common font
  16.     and a test string will be printed using the actual font. 
  17.  
  18.     Since Fontaloger prints each page as is it created, clears the document,
  19.     and starts the next page on an empty document, there is no limit to the
  20.     number of fonts, or pages of fonts which can be cataloged. In contrast,
  21.     accumulation (as a single Final Writer document) of a large font catalog
  22.     could exceed the available memory of an 8 MB Amiga. This is because font
  23.     files typically range in size from 20k bytes to 100k bytes each and 
  24.     subtract that amount from available memory as they are loaded.
  25.  
  26.     A catalog page can contain one, two, or three columns of font samples,
  27.     allowing 15, 56, and 108 samples per page respectively. You can choose
  28.     from these based on your preferences and available memory.
  29.  
  30.  
  31. Requirements:
  32.  
  33.     Final Writer V4 (Fontaloger prefers to use the FW V5 public screen)
  34.     OS 2.04+ (requires V2.04+ Request commands below)
  35.     AmigaDOS commands:
  36.         RequestFile, RequestChoice, Wait, Delete, Run, Rename, List, Sort
  37.     6MB RAM (>8MB recommended)
  38.  
  39.  
  40. Installation:
  41.  
  42.     1.) Put Fontaloger and Fontaloger.doc in the FWMacros directory.
  43.  
  44.     2.) Add the following 'assign' in your S:User-Startup and reboot.
  45.  
  46.     --> Assign FinalWriter: <Final Writer program directory path>
  47.  
  48.         The stuff in < > is the path to Final Writer - it includes the 
  49.         Final Writer directory name. Fontaloger will execute Final Writer
  50.         automatically if you perform this step - it is not a NECESSARY
  51.         step.
  52.         
  53.  
  54. Starting Fontaloger:
  55.  
  56.     From Final Writer:
  57.  
  58.         1.) Run Final Writer
  59.  
  60.         2.) Select Fontaloger in 'User' menu -> Other -> ARexx Script...
  61.  
  62.     From CLI:
  63.         1.) You will need the 'assign' in step 2 of the installation 
  64.             instructions in place.
  65.  
  66.         2.) At the CLI prompt, enter the following command.
  67.  
  68.     --> rx FinalWriter:FWMacros/Fontaloger
  69.  
  70.         3.) If Final Writer is not already running, it will be 
  71.             started automatically.
  72.  
  73.  
  74. Using Fontaloger:
  75.  
  76.     1.) Execute Fontaloger in one of the two ways described above.
  77.  
  78.     2.) Select 'Continue' in the first requester.
  79.  
  80.     3.) Select the printing mode:
  81.  
  82.         * 'Autoprint' will send the pages to the printer automatically
  83.         as they are completed. There is no possibility of saving the
  84.         pages as a FinalWriter document in this mode. You will want
  85.         to turn your printer on right away if using this mode.
  86.  
  87.         * 'Page prompt' mode will present a requester and beep when
  88.         each page is completed and ready to print. Saving each page as
  89.         a separate Final Writer document is possible in this mode.
  90.  
  91.         * 'List to file' will not print, but will create an ASCII
  92.         listing of all the files which would otherwise be printed in the 
  93.         'Autoprint' or 'Page prompt' modes. This is good for making a
  94.         'trial run' to see how things will go. The file list is created
  95.         in RAM:FontList. You can view this file with any text editor.
  96.  
  97.     4.) Select the number of columns of text (font samples) you want
  98.         printed on each page: 
  99.  
  100.         * 'One' column mode will print about 15 fonts per page. 
  101.  
  102.         * 'Two' column mode will print about 56 fonts per page.
  103.  
  104.         * 'Three' column mode will print about 108 fonts per page.
  105.  
  106.         The amount of RAM on your particular Amiga may also play a
  107.         role in your selection process. Keep an eye on your free RAM.
  108.  
  109.         In 'List to file' (see 3. above) mode, the number of columns is 
  110.         used to generate an estimate of the number of pages required to
  111.         print the listed fonts.
  112.  
  113.     5.) Select the font path:
  114.  
  115.         Fontaloger defaults to the current Final Writer font path.
  116.         Navigate your way to the directory which hosts the fonts that
  117.         you are interested in. Any selected filenames will be ignored.
  118.         Selecting 'Cancel' at this requester will abort Fontaloger.
  119.  
  120.     6.) Enter the font pattern:
  121.  
  122.         The font pattern serves as a filter for selecting (from the
  123.         specified path) only those files which are Final Writer
  124.         compatible fonts. Files which match the pattern and are not fonts
  125.         will cause Final Writer to present an error message. Repeatedly
  126.         clicking 'Ok' at this requester can get old. 
  127.  
  128.         The default pattern is '~(#?.info) ALL AutoID'. The ~(#?.info)
  129.         parameter instructs Fontaloger to ignore all files ending with
  130.         '.info' and 'All' causes all subdirectories to be included in the
  131.         catalog. If you are not familiar with AmigaDOS pattern matching, 
  132.         you should consult your AmigaDOS manual and practice using the 
  133.         AmigaDOS 'List' command.
  134.  
  135.         The 'AutoID' parameter instructs Fontaloger to inspect every file
  136.         which matches the above pattern and verify their first two bytes
  137.         against each of three font header templates. If the first two bytes
  138.         of a file matches one of the templates, there is a high likelihood
  139.         that this file is a valid Final Writer compatible font. Although
  140.         the 'AutoID' feature slows the process (by opening and closing each
  141.         file to inspect the header), it almost guarantees that the default
  142.         pattern will be sufficient.
  143.  
  144.         Note that 'AutoID' excludes files which do not match one of the 
  145.         three header templates. Therefore it is conceivable that a Final
  146.         Writer compatible font with a different (new) header will be
  147.         excluded from the font list. If this, or the opposite (a non-font
  148.         getting past the test) happens to you, please let me know, and if
  149.         possible, Email the offending file to me.
  150.  
  151.     7.) Inspect the advance analysis and select first page:
  152.  
  153.         Fontaloger counts the number of files (which are hopefully all
  154.         fonts) which match the font pattern and path and estimates
  155.         the number of pages that will be required to print them all.
  156.         If you are unhappy, you may select 'Abort', otherwise select
  157.         'Continue', or 'Skip pages'. 'Continue' will start page creation
  158.         at page 1 and continue until completion or until aborted. 'Skip
  159.         pages' allows you to continue from where you left off if you
  160.         had to abort an earlier multipage print. Page calculation for the
  161.         'Skip pages' option assumes that all files skipped are valid
  162.         fonts. So, if you printed five pages and got tired of clicking
  163.         'OK' on the 'bad font' requester, for instance, you can abort and
  164.         restart using a better pattern, then 'Skip' the pages that were
  165.         already printed. If any files that match your pattern are not
  166.         fonts, the 'Skip pages' function will not operate properly.
  167.  
  168.         In 'List to file' mode, the only option is 'Done' - you may now
  169.         view the RAM:FontList file with the text editor of your choice.
  170.  
  171.     8.) Let 'er rip!:
  172.  
  173.         Fontaloger draws a header with the full path to the specified
  174.         font directory and 'page #' at the top of the page. Below, 
  175.         Fontaloger draws both the font name (with path from the 
  176.         specified directory) in the 'Courier' font and a 'test string'
  177.         of characters in the font itself. This is repeated until the 
  178.         page is full. The list is alphabetized. 
  179.  
  180.         Fonts that are unusually wide may not fit completely within its
  181.         column. In this case, Fontaloger will truncate the test